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1. Introduction 



PEEK is a utility program designed to operate under the ITS time 
sharing gystem. It enable* a usar to monitor a variety of aspects of 
the time sharing system by providing periodicly updated display output 
or periodic printed output to teletype or line printer. 

Just uhat Information It being presented to the user le 
controlled by PEEK'e information mode. The available modes are lleted 

in Section 3 be I an. Section 5 describee hou PEEK determlnee uhlch 
device to output on. Section 2 describee, in general, hou the ueer can 

Input commands to PEEK. 

The first line of ell pages output by PEEK Is as follouai 

ITS xxx PEEK yyy nWdd/yy hh:mm:« STME-OOiHHiMMtSS 

In this line ioo< le the version number of the system in use and 
yyy ie the version number of the PEEK in use (so bugs can be matched to 
exact version). At the time this msmo uas released, PEEK 271 ua* the 
version In use. DG:MM:MMtSS Is the length of time that the 
particular ITS system running has been up and mm/dd/yy hhimmiM le 
thm current date and time according to ITS. 

For many modes (those ulth the mode letter just after the eub- 
Section number fol loued by a colon in Section 3) a standard second line 
is output for any core or disk memory error. This line lists the 
following three errors if any have occuredi 

I. Irrecoverable disk errors. 

2* Core msmory parity srrors. 

3, Core memory failures to respond (NXffl, 

The laet line of all pages output to the 348 display by PEEK ie a 
Met of mode command letters which can be given by light penning them 
ulth effects identical to typing them. 



2. Commend Formate *- 

PEEK is an unusual program In that It Interprets all characters 
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typed at It Immediately at the Interrupt level. Commands to PEEK are 
• I I elngle letter* or control characters, sometimes preceded by a 
numeric argument* The commands Mated En Sections 5 and 6 of thie memo 

take effect Immediately and do not affect any number that PEEK may be 
accumulating from digits typed at it. 

The commands Hated in Section 3 change PEEK'S information mode. 
They may or may not Make use of a numeric argument but all clear any 
number PEEK may have accumulated* These commands normally start PEEK 
Immediately displaying the Information requested. 

PEEK Interprets digits typed at 1 1 as forming an octal number. 



3, Information Model AvWiette 



Belou are Meted alphabeticly all the different information modes 
of PEEK. Normal ly. the Information specified by the current 
Information mode ie output to the currently selected output device (eee 
Section 5). After PEEK has done thie It Halts m while and then 
repeats- Thie waiting period is fi»ed at ten seconds for some 
Information modes that present Information that Is not expected to 
change. For most modes, the waiting time Is initially ten seconds but 
can be changed by the Z commend (sse Section 6). 



3.1 A fiRPA Network Sockets 

The active ARPA network sockets and pseudo-teletypes In the 
system are Hated by this mode. Aftsr a heading line, one line of 
Information Ie given for each socket with the following information* 
(1) the socket's logical Index number, (2) the index, UNAI1E. and JNAflE 
of the user associated with the socket, (3) the local socket number and 
the etate of the socket, (4) the foreign host and socket number 
associated with the socket, and (S) the outstanding message and bl t 
allocations on the socket. 

If any pseudo- teletypes (STY) are In use, they are Mated belou 
mil the sockets under a different heading line. On each line Ie listed 
the following: (1) the user Index, UNAHE, and JNAME of the procedure 
that hae the STY open as a teletype, (Z) the teletype number of the 
STY. and (3) the UNAflE of the job that has the other end of the STY 
open* 

3.2 C: Disk Channels 
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This nde I iota the channels actually In um for the transfer of 
information between disk Files and procedures. After an explanatory 
heading line, one line Is dlsplaysd for each channsl ulth the folloulng 
information: (1) the logical channel number. 12) the index. UNAME, and 
JNAHE of the user procedure that has the channel open, (3) various 
statue lettare ae listed In the next paragraph, (4) a count of the 
number of words transferred, and (S) the system name and tuo file names 
of the ft le. 

The fol lowing are the disk transfer statue letters that can 
appear In the disk channels mode output! 

A File address altered by .ACCESS or otherwise. 

8 Core transfer hung on active buffer. 

E Transfer has reached EOF, 

F Hung In directory full. 

L Channel locked. 

H Master directory read* 

P PDUflP mods transfer, 

R Read. 

T Track Usags Tab Is read. 

U User directory read. 

H Write. 

? Parity error on read. 

* Delete file when channel closed. 

3.3 Q Qlek Directory 

Thle mode displays the disk master f I le directory ("H.F,0. 
(FILE)"), uhieh lists the names of all the user directories, and then 
1 iete the user directory (".FILE. (DIR)') fop the current defaul t 
system name associated ulth PEEK. If output is to the 348 display. It 

may be possible to Changs this default system name by light penning one 

of the names In the master directory display. 

3.4 G Swap/Schedule Variables 

3 3 
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Thla mode displays Information very similar to mode N uith 
certain additional data related to the ITS scheduler & swapping 
routines. In particular, the Interrupt request words in the per job 
Information are replaced by the number of page suap In requests and the 
total run ties used Is replaced by the average recent load represented 
by the Job In pago-ml I I Isscondt . 

In addition, an extra line Is displayed for each top level job 
showing the average percent of machine tine used and load In page- 
Milliseconds for the tree topped by that job (but nota that all 
disowned jobs are combined). 



3.5 H: Memory Graph Display 

This mode Is only available on output to the 348 display. It 
shows a graph of actual core memory usage. Horizontal poel t Ion 
repreeente absolute address and vertical position represents type of 
use. Uorde are dieplayed on the left edge of the screen describing the 
use shoun to their right. An occurrence of a block of memory at 
several vertical positions repreasnts a shared block. (See aleo mode 
M.1 



3.G I Available 1/0 Devlcsa 

The symbol ic devlcee Implemented In the ITS system In use are 
Meted by this mode. Output Is repeated after a ten second delay. 



3.7 L Console Lines 

Thie mode simply outputs ths system supplied directory for device 
TTY. Currently this contains a header line. and. for each teletype 
line in use. Its TTY number, the UNAflE and JNAHE of the procedure 
actually connected to the console, core of this procedure, total core 
of that user, and user inde*. A final line I lets free core and swapped 
out pages. 



3.6 M: Qemory Use List 

A display Is provided by this mods of all of the usee to which 

actual core memory is being put. After an explanatory heading line* 

one line le ehown for each use In decreasing ordsr by actual core 
memory occupied. 

Each line beglne with the type of use, either the UNAME and JNAHE 
of a procedure or a single descriptive word such as "FREE* for unused 



/ 
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actual memory or "DSXBLF* for disk transfer buffere. A ".-." ie 
displayed juat after the nanes of a stopped job- After the type of 
use, the total number of actual core blocks dedicated to that use is 
Meted* followed, for procedures* by the foJIouing: (1) the number of 
the highest virtual page slot In use In that procedure, (21 the number 
of Its pagee that are shared uith any othsr procedures, (31 the number 
of Its pages that are not In actual memory but have been suapped out, 
(4) the total number of page slots In use by the procedure, and (S) the 
resources in use by the procedure (aee Section 4.1). 

3.9 N; tiornal lode 

This is the Initial and most commonly used information <*ode In 
PEEK. 

3.9.1 The Top 

After the normal top of display lines (see Section 1), N mod* 
displays one I ine of special information In the form of several 
variable names followed by their values. Thess namss arm as follows! 

flEHFREE Number of blocks of unused actual core memory. 

U5RHI Number of blocks of user variables currently 

allocated In the system. 

RKABLU Number of runable ussrs (including the PEEK 

displaying It)* 

Tffljflfl Total user memory blocks of active ueare. 

AUSOPG Number of active ussr suappsd out blocks (pages). 

3.9.2 The fliddle 

After the special Informal Ion I Isted In the Section above, a 
heading line Is displayed followed by one line of Information per job. 
The trme structure of jobs Is shoun by ths indentation of the firet feu 

Items after the ueer lnde« number on each line. Top level console 
controlled, dleounad, or systsm jobs are leftmost. Under each appears 

I te Inferiors with Its immediate Inferiors indented one space, I te 

second lava! Inferiors Indented tuo spaces and appearing aftar their 

Immediate superiors, etc. 

The Information appearing for each job Is as follousi (1) the 
ueer Index, UNAHE. JNAOE, and current system name, (2) the run statue. 

5 6 
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teletype status, and resources seized (sse Section 4) t (3) the number 
of blocke of mewory In use by the job and the number of euch blocks 

that are sueppsd out, (41 the average percent of available machine time 
used recently by the job. (5) tuo uords of possible pending interrupts 

for the job, end 16) the total amount of actual run tine that has been 
used by the Job. The preceding list appliss to output to the line 
printer or 34B display (see Section 5). Other output Is abbreviated by 

dropping some of the Information. In particular, the JNAflE is dropped 

for top level non-dlsouned jobs and the UNAflE dropped for their 

inferiors. 



3.9.3 The Bottom 

Space permitting, tuo lines of special Inforaatlon are output at 
the bottom of the N mode display. The first le a line of totals which 
glvee tha total msmory In uss by all Mated jobs (no deduction le isede 
for ehared pages), the average total percent of machine time used 
recently by listed Jobs, and the total amount of run time for all 
I lated jobe* 

The laat line shows the total amount of run time for all uears 
that have logged out during the system run so far, the amount of 
machine time used by jobs killed by users uho Brn etlll logged In, and 
the amount of run time for the null job. 



3.18 S Single Tree 

Thie mode outputs the same Information In the same format as the 
N mode except that only procedures in a single job tree ure Included. 
The 3 command should be preceded by ths user Index of a job In the 
tree to be displayed. If no argument Is given the tree containing the 
PEEK Ml 1 1 be displayed. 



3.11 T Iranalatlon Table 



The from 


and 


appl icabl 1 1 ty of 


the 


this mode. 





to device, system name, file names, and 
aygtsm translation table entries are I is ted by 



3.12 Ui DEC Tape Channels 

Thle mode ie similar to the C mode for disk except that It 
applies to the DEC tape drives. As uelt as listing information for 
open channele. It I lets various Information for each drive, Thle per 
drive information Includes the directional motion statue of the drive* 
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the tape block the system It trying to move It to, and the current 
believed poeltlon of the tape. Also lilted for each drive le a 
directory pointer, the UNAflE of the user uho last caused a directory to 
be read in for that drive, and the UNAHE of the user, if any, to whoa 
the drive le "assignsd". 

If the directory pointer for a drive is -1 it means that the 
system ie not retaining a directory for that drive and the tape can be 
■afely flapped by hand. Otherwise, the directory pointer givee the 
location In memory of the tape's directory. Even after a tape has bean 
flapped and no directory is being retained for it, this mode displays 
the UNAflE of the last job to cause a directory to be read in froa that 
drive. 



3.13 V Single Procedure Variables 

riany of the user variables for a single procedure can be 
inspected nl th this mode. After showing the procedure's names, run 
etatus, and resources, the octal values of a number of named variables 
are displayed. Then, under a heading I tne, the con tent e of the 
procedure's ACs, input-output channel words and input-output status 
uords Bre listed. For open channels, the dsvica and mode symbol la 
also shown* 



3.14 * A/0 and D/A rkjltiplenors 

This mode outputs the dlgl tal Izatlon of all the mul tiplexed 
analog to digital Input channels and the value being output to each of 
the multiplexed digital to analog channels. 

3.15 Y OEC Tape Directory 

This mode simply outputs the system supplisd directory for a 
particular OEC tape. It should be precedsd by a drive nuaber. 

3.1G \ Scheduler History 

Users that have recently caused schedules by being blocked are 
Mated by this mode, Bscauss ths psrcsnt of ovsrhead tine in Its le 
related to the frequency of schedules, this mode may be ueeful in 
finding the cause of excessively frequent schsdules. 

After a heading line. It lists procsdures recently scheduled in 
order of decreasing number of schsdules. For each procedure It gives 
(II the user index, UNAHE . & JNAHE, (2) the number of recent schedules. 
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(3) the average run time per schedule. (4) the percent of schedules 
caused bg blocking caused by page faults. (5) the most common PC uhen 
scheduled (with an a in front If executive mode) and the number of 
schedules at that particular PC. 

3.17 T Explanation riods 

This mode outputs a list and brief applanation of PEEK'e 
commands* Output Is repeated after a ten second delay* 



4. Special Output Raid Formate 



4,1 Resource Lettere 

The following are the gyatem resource letters used In modes O, 
N, M ( S, and V explained abovet 

5 The procedure has control of the PDP-6. 

fi The procedure hae control of the IBT1 compatible 

magnetic tape drive (f1T8). 

C The procedure Is now using, or uaa the last to 

uee, the ITS core allocator. 

Q The procedure has control of the DEC 348 display 

(01 St. 

i The procedure le In "IOT-user" mode 1.I0TLSR). 

This letter can be present for more than one procedure. 



(LPT), 



The procedure has control of the line printer 



The procedure has seized the master user 

facility (.MASTER). 



tPLT) t 



The procedure has control of the CalComp plotter 



The procedure has control of the paper tape 
reader (PTR). 



(TAB). 



The procedure has control of the Sylvan la tablet 



S 8 7 
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1 The procedure has control of the paper tap© 

punch IPTP). 

Y. Tha procedure hat control of tha vidiaactor 

(NVOK 

X Tha procedure ie In real tine mode (.REALT). 

4.2 Proceae Run Statue 

The tol lowing Sections explain the procedure run atatua field 
output by nodee G, N, 9, and V: 

4.2.1 Prefix 

One of the following charactere will appear at the beginning of 
tha atatue codei 

> Swap blocked. Thle procedure le being blocked 

from running by tha euap scheduler to atop threshing. 

Desired out. This procedure le not euap blocked 
but the euap scheduler has decided to euap It out. 

it PI in progress. This procedure le not euap 

blocked or desired out but Is processing a software Interrupt* 

(Space) None of the above apply. 

4.2.2.1 Body If Stopped 

If a procedure le stopped, the body of I te statue field la a 
number output In an unusual format. The flret tuo octal digits of the 
number are printed as an unsigned number, then an "I" la output, than 
the reet of the number ul th leading zeros eliminated. The resulting 
figure to the right of the "I" ie the count of traneient raaeona for 
tha procedure to be stopped. If thle count le persistently non-zero. 
Bn Internal system error has probably occurred. 

In tha figure to tha left of tha "I". tha top four bite have 
apeclal meaning. The 48 and 20 bits are used by the core allocator 
uhan It le moving or modifying the core inage of proceduree. The 18 
bit Is the a>ost coawon and ie the only bit directly controllable by 
user procedures to etart and stop other procedures. Tha 4 bit le uead 
•a a temporary atop bit by some system calls. If the 40. 20. or 4 bite 
slay on pereletently, there is probably something wrong. 

3 9 
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4.Z.2.2 Body II Hung 

A procedure can be hung (execution teaporerl ly blocked) either 
due to waiting for a pags of Its core Image to be swapped In or due to 
a Malt for eon condition in the execution of a system call- 
in the cate of a hung tyatem call, PEEK simply displaye the name 
of the system call or, for an input-output transfer, the device nana 
and tranefer type. If the procedure ie blocked ualtlng for a page to 
be swapped In, the word "PAGE" Is displayed, unless the page ie needed 
to handle a software interrupt to the ueer in uhich caee "IPAGE* la 
displayed. 

4.2.2.3 Body If Running 

If a procedure is running in user rode, the uord "RUN" la 
displayed as the body of its status field. If It le executing a system 
call, the same word Is displayed as If It were hung in that system call 

(eee Section 4.2.2.2) except that a "+* is added in front. There am 

several reasons, however, that a procedure can be running In executive 
mode without havelng executed a noreal system call* For example, If 

the procedure has Just executed an illegal Instruction, "XXX" will be 
displayed, and if It has just executed a UUQ that will be relected bock 

to It as a user UUQ, the uord "UUO" will be displayed. 



4.2,3 Suffix 

Under soae circumstances, a system cal 1 being executed by a 
procedure, say PI, wilt have to make sure that a second procedure, P2, 
is temporarily not running In executive node* This may necessitate PI 
waiting until P2 Is Interruptlble If P2 le Initially running in 
executive mode. If PEEK Is run during this waiting state, a *>" 
followed by the user index of P2 will appear at the end of the etatus 
field for PI and a "<" followed by Pi's Index correspondingly after 
P2'e status. This situation ia referred to as PI PCLSRlng (P-C- 
losering) P2. 

This state should be extremely transient. If you see this suffix 
display even once, you should suspect some problem, 

4,3 Process Teletype Statue 

The teletype status field displayed for a procedure will be one 
of the following five things! 

OISOUN The procedure Is disowned and can not have a 

console associated with It* 

IB 19 
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Tn The procedure is immediately control ling and 

being controlled by "teletype" number n. 

> The procedure has eeelgned i to teletype downward 

In I ta procedure tree. The number should be displayed by one of Ita 
infer lor procedures. 

< The procedure has had its console taken auay by 

a higher level procedure. The number should be displayed by some other 
procedure In i te procedure tree. 

? There ie no evidence of a console ever being 

directly associated ulth the procedure. (It Bight be a neuly created 
inferior. ) 



-* 8. I/O Control •- 

PEEK has four different modes of output (not to be confused ulth 
the information modes listed in Section 3*) Tuo of these, which 
provide the Met verbose output, are intended for output to the line 
printer and the 348 display* The remaining tuo nodes are for printing 
coneolee (teletypee) and alpha-numeric display consoles (Datepointel . 

The exact information displayed for various Information modes ie 
affected by this output node. Especial ly for the more complex 

information modes, like N, there is An abbreviated version of the 
output for printing consoles. An intermediate one for alpha-numeric 
displays, and a complete vereion for the line printer and 340 displays. 

In the deecrlptlone of information modes, usual ly the soot complete 
output form was explained. 

PEEK starts In either the printing or alpha-numeric display 
modes, depending on the nature of the user'e console, unless it finds 
that the user's console Is at a 34B screen or it can not open device 
TTV for output. In either of these tuo casee It tries to uee the 34B 
display output modes. (If the 348 display is not tried* a flag is eet 
that is cleared only by A Y which Inhibits further attempts at using the 
349.1 The following commands can be uied to change PEEK's output modes 

*B This suitchss output to the line printer If It 

ie available* If It la not available, the output device ul 1 1 be 
unchanged. 

*E This command releases the line printer If PEEK 

Ie using It. It then resets the output mode through the same procedure 
ae is used uhen PEEK is first started. 
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*N This command releatii the 348 display. If PEEK 

is using It. and than It sets a flag uhich inhibit* any PEEK attempt at 
using the 348. This flag is cleared only by A Y. Finally, PEEK changes 
to typa out or alpha-numeric display mode. 

A Y PEEK Mill try to seize tha 348 display for 

output on receipt of this command- If It eucceeds, tha output mode 
Mill be set to tha 348. Otherwise, output uill revert to tha user* a 
console. In either case, the flag mentioned under *N above ia cleared. 



-+ E. Miscellaneous Cotrmands «- 

Tha folioulng ere miscellaneous PEEK command*! 

P This la tha proceed command. 

If PEEK Is running under a HACTRN, this command u)ll return 
control of the user's console to HACTRN but leave the PEEK running. If 
348 display or line printer output Is selected. It uill continue. If 
the PEEK is running as a top lavs) Job. this command uill cause it to 
logout. 

Tha P command uses .VALUE to return the atring "iPROCED - 
to P£EK*s superior procedure. 

Q Thia ia the guit command. 

If PEEK Is running undsr a HACTRN, thia command uill destroy 
the PEEK it is typed at and return control of the user's console to 
HACTRAN. If the PEEK is running as a top level Job, this command uill 
cauee it to logout. 

Tha □ command uses .VALUE to return the string "iKILL " to 

PEEK'S superior procedure. 

Z This Is the dole command. 

It takee a numeric argument and sets the standard update 
delay to that number of seconds (see Section 31. 

ISpacel This ia a sort of null mode command. It 
doee not change PEEK'S information moda but causes It to Immediately 
begin updating the current output. 
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